home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 49 / Amiga Format CD49 (2000-01-17)(Future Publishing)(GB)(Track 1 of 3)[!][issue 2000-02].iso / -in_the_mag- / pdselect / pio_icon / readme < prev    next >
Text File  |  1999-11-27  |  6KB  |  144 lines
  1. ---------------------------------------------------------------------------
  2.  personal_icon_io.library                      by Bware
  3. ---------------------------------------------------------------------------
  4.  
  5. ·FEATURES·
  6.  
  7.  This  ICON  I/O  library  allows  you to load and save images created with
  8.  PPaint  as  Workbench    icons.    You can load or save the normal or selected
  9.  image of an icon and set the type of a new icon. Tooltypes are preserved.
  10.  
  11.  This  version    comes  with  OS  3.5  and  NewIcons  support.  No  need for
  12.  "injectbrush"  or  other  utilities  --  you  won't even need the NewIcons
  13.  patch, just newicon.library (to create NewIcons) somewhere in libs:.
  14.  
  15.  
  16. ·INSTALLATION·
  17.  
  18.  Simply use the Installer script. 
  19.  
  20.  Alternatively,  you  may  copy the personal_icon_io.library to PPaint:libs
  21.  and  turn  off  PPaint's  automatic  icon generation by setting ICONS=0 in
  22.  PPAINT:PPaint_Prefs/Startup_1.set.
  23.  
  24.  
  25. ·USAGE·
  26.  
  27.  Loading/Saving Options
  28.  
  29. -Tooltype
  30.  This icon saver supports TOOL, PROJECT, DRAWER, TRASH and DISK types. This
  31.  type is  only    set if the icon did not previously exist.  Then the default
  32.  image is loaded for this type.
  33.  
  34. -Selected
  35.  Load  or  save  the  selected    image  of  an  icon.  If saving there is no
  36.  consistency check between the size of the first and the selected image. If
  37.  this  switch  is  not    checked the normal image is loaded. The next option
  38.  provides a mode for loading both images at once.
  39.  
  40. -Both
  41.  The  'Both'  switch  in  the loader/saver settings allows you load or save
  42.  both images at once. They are separated by a line in color 1. When saving,
  43.  the  upper  half  of  the  brush  is the normal and the lower the selected
  44.  image. A separating line (i.e. odd brush height) is discarded. This switch
  45.  is enabled by default.
  46.  
  47. -NewIcon
  48.  The   image   is   loaded   from   the  NewIcon  tooltypes  or  saved    via
  49.  newicon.library. Color 0 is marked as transparent color.
  50.  
  51. -ColorIcon
  52.  The  image  is  loaded  or  saved  by    the icon V44 functions. The current
  53.  background  color  is    marked    as  transparent. When saving ColorIcons the
  54.  NewIcon tooltypes are cleared.
  55.  
  56. -Frameless (only available if saving a ColorIcon)
  57.  The  new  icon.library  V44  allows you to switch off the border around an
  58. icon. This Flag is passed to the library.
  59.  
  60.  
  61. ·NOTES·
  62.  
  63.  Colors  are  not  set    for  Standard  Icons - get WB screen palette first.
  64.  NewIcons  and    OS  3.5 Icons have a brush-palette that has to be activated
  65.  with  alt-b.  NewIcons  support  is  turned on when the newicon.library is
  66.  successfully  loaded.    OS  3.5  support  i  enabled if icon.library V44 is
  67.  found.
  68.  
  69.  To load Disk-icons enter ":Disk.info" in the filerequester. The use of the
  70.  .info suffix is optional, but sometimes required to get around limitations
  71.  in  the  PPaint  filerequester  (i.e. writing  a directory icon). To avoid
  72.  problems  with  graphics files without filename extensions the auto loader
  73.  only recognises .info suffixes. PPaint clears the 'e'xecute file attribute
  74.  -- use .info extension for saving icons for existing programs.
  75.  
  76.  NewIcons  saver  makes color 0 transparent, only used colors are saved. OS
  77.  3.5 icon saver marks the current background color as transparent.
  78.  
  79.  In  BOTH  mode  the  palettes of the normal and selected image are merged.
  80.  Note  that  standard newicons share a common palette and have a fixed size
  81.  of  36  by  40 pixels. NewIcons have a maximum size of 93x93. OS 3.5 icons
  82.  have a limit of 256x256 pixels.
  83.  
  84.  Saving  normal  and  selected image separately may save you a few bytes. A
  85.  switch is provided to turn NewIcons loading off and use standard WB icons.
  86.  If  OS  3.5 icon loading is selected the NewIcon switch is ignored. If you
  87.  save icons in the OS 3.5 format you may specify a `Frameless` Flag.
  88.  
  89.  Tooltypes   are  not  modified  when  overwriting  existing  icons.  As  a
  90.  consequence NewIcons images remain intact when overwriting the file with a
  91.  WB  icon.  The  OS 3.5  icon saver DISCARDS newicon images. (Maybe another
  92.  switch ?)
  93.  
  94.  Saving standard and NewIcon images deletes the ColorIcon information.
  95.  
  96.  
  97. ·BUGS·
  98.  
  99.  Previous  icon_io.library  versions (<5.8) did not clear NextImage fields,
  100.  some programs (esp. Workbench Information) strongly dislike this :( Please
  101.  resave icons created with earlier versions.
  102.  
  103.  There    is  no    consistency  check  between  the  size of the first and the
  104.  selected image.
  105.  
  106.  NewIcons  and    OS  3.5  icons    can contain upto 256 colors per image. When
  107.  merging  palettes  for  the  normal  and the selected icon images this may
  108.  exceed the max. allowed colors for PPaint (256).
  109.  
  110.  The  WB  IconEdit  has  problems  with  icons which have transparent color
  111.  different than 1.
  112.  
  113.  
  114. ·COPYRIGHT·
  115.  
  116. ---------------------------------------------------------------------------
  117.     __ _     _      __  ___
  118.  A //_)\\   //\  //_)//_
  119.   //__) \/\//¯¯\// \//___ PRODUCTION © 1999           <amiga@nikocity.de>
  120.  
  121.    Elmar Plischke  --  Schollstr. 68  --  27755 Delmenhorst  --  Germany
  122.  
  123. ---------------------------------------------------------------------------
  124.  
  125.  The  Personal_icon_io.library    is  freeware  and  comes with ABSOLUTELY NO
  126.  WARRANTY.  Redistribution  allowed  if  the package is left unchanged. The
  127.  author  is  not  responsible for any damage caused by the use or misuse of
  128.  this documentation and/or the program it describes.
  129.  
  130.  Program  written  by  Elmar Plischke. Personal_icon_io.library was created
  131.  with  gcc2.95.1.
  132.  
  133.  Any  feedback    like  postcards/PPC boards/mindblowing icon collections/...
  134.  welcome!
  135.  
  136.  All icons are (C) by Matt Chaput and Amiga, Inc.
  137.  
  138.  NewIcons is written by Eric Sauvageau and Phil Vedovatti.
  139.  
  140.  Cloanto  is  a  registered  trademark,  and  Personal Paint and PPaint are
  141.  trademarks of Cloanto Italia srl. Some code copyright © Cloanto Italia srl
  142.  (Cloanto), used  under  permission. The program and its accompanying files
  143.  are for non-commercial use only.
  144.